v1.4.1

Compare Source

v1.4.0

Compare Source

We are excited to announce the release of Upjet v1.4.0, which includes several enhancements and new features aimed at improving the flexibility, usability, and efficiency of the code generation pipeline and API management. Below are the key updates in this release.

Release Highlights

1. Generate singleton lists as embedded objects

• Terraform configuration blocks with a MaxItems constraint of 1 are now generated as embedded objects in MR APIs instead of lists. This change simplifies updates and patches via SSA by eliminating the need for specific configuration for associative lists.
• Introduced runtime conversion logic to convert embedded objects back to singleton lists for Terraform operations and vice versa for updates to spec.forProvider, status.atProvider, and connection details.
• Added a schema traverser to decouple Terraform schema traversal from various actions, allowing providers to generate singleton lists as embedded objects using the ujconfig.SingletonListEmbedder configuration.
• Supported the generation of new CRD API versions with embedded object schemas while maintaining existing versions.
• For further details: https://github.com/crossplane/upjet/pull/387

2. Support for specifying the controller reconciliation/watch version

• Added config.Resource.ControllerReconcileVersion to specify the CRD API version that the associated controller will watch and reconcile, preventing unnecessary webhook conversions for multi-versioned CRDs.
• For further details: https://github.com/crossplane/upjet/pull/400

3. TerraformConversions interface for handling conversions between Crossplane and Terraform

• Introduced config.Resource.TerraformConversions for handling data transformations between Crossplane and Terraform layers. The initial implementation, config.singletonListConversion, manages conversions between singleton lists and embedded objects.

4. Dynamic code generation pipeline for multi-version APIs

• Addressed name conflicts in the code generation pipeline by making it aware of previous CRD versions. This allows dynamic resolution of conflicts when generating new API versions, such as v1beta2, while older versions like v1beta1 exist.
• Deprecated the config.Resource.OverrideFieldNames API in favor of the new config.Resource.PreviousVersions mechanism, ensuring more efficient and dynamic prevention of type name conflicts.
• For further details: https://github.com/crossplane/upjet/pull/402

5. Support for Secret References in spec.initProvider

• Enabled generation of secret references for sensitive parameters under the spec.initProvider API tree. This allows full specification of sensitive parameters, such as passwords, in the initProvider.
• Adjusted code generation and runtime logic to support secret references from both spec.initProvider and spec.forProvider, with forProvider references taking precedence when conflicts arise.
• For further details: https://github.com/crossplane/upjet/pull/406

6. Late-Initialization configuration API

• Introduced a new late-init API to skip fields in spec.initProvider that are already filled, preventing the late-init operation in forProvider from overriding these fields. This ensures the integrity and intended configuration of fields specified in initProvider.
• For further details: https://github.com/crossplane/upjet/pull/407

7. Documentation Improvements

• Improvement on configuring a resource external name document: https://github.com/crossplane/upjet/pull/392
• Improvement on clarify documentation around reference type name: https://github.com/crossplane/upjet/pull/393
• Improvement on selector field name documentation: https://github.com/crossplane/upjet/pull/399

What's Changed

• chore: improve doc about configuring a resource external name by @​yordis in https://github.com/crossplane/upjet/pull/392
• chore: clarify documentation around reference type name by @​yordis in https://github.com/crossplane/upjet/pull/393
• Updates the MPL code used in NOTICE by @​jeanduplessis in https://github.com/crossplane/upjet/pull/394
• chore: improve docs about selector field name by @​yordis in https://github.com/crossplane/upjet/pull/399
• Generate singleton lists as embedded objects by @​ulucinar in https://github.com/crossplane/upjet/pull/387
• Allow Specification of the CRD API Version a Controller Watches & Reconciles by @​ulucinar in https://github.com/crossplane/upjet/pull/400
• Add example converter for conversion of singleton lists to embedded objects by @​sergenyalcin in https://github.com/crossplane/upjet/pull/397
• Add config.Resource.PreviousVersions to specify the previous versions of an MR API by @​ulucinar in https://github.com/crossplane/upjet/pull/402
• Generate Secret References for Sensitive Parameters under the spec.initProvider API tree by @​ulucinar in https://github.com/crossplane/upjet/pull/406
• Add a new late-init configuration to skip already filled field in spec.initProvider by @​sergenyalcin in https://github.com/crossplane/upjet/pull/407

New Contributors

• @​yordis made their first contribution in https://github.com/crossplane/upjet/pull/392

Full Changelog: crossplane/upjet@v1.3.0...v1.4.0

v1.3.0

Compare Source

Release Highlights:

1. New Feature: Introduce MR Metrics

We are excited to introduce a new set of managed resource (MR) metrics in this release. These metrics are pivotal for monitoring the state and performance of resources managed through Crossplane. This enhancement follows the implementation guidelines from the provider-kubernetes and incorporates changes from crossplane-runtime. The newly available metrics include:

• crossplane_managed_resource_exists{"gvk"}
• crossplane_managed_resource_ready{"gvk"}
• crossplane_managed_resource_synced{"gvk"}
• crossplane_managed_resource_first_time_to_reconcile_seconds{"gvk"}
• crossplane_managed_resource_first_time_to_readiness_seconds{"gvk"}
• crossplane_managed_resource_deletion_seconds{"gvk"}
• crossplane_managed_resource_drift_seconds{"gvk"}

For a detailed overview of the implementation, please refer to this PR in crossplane-runtime.

2. Bug Fix: Immediate Sync Status Update on Async Failures

This update addresses a critical bug related to asynchronous operation failures (Issue #​1164). With this fix, the "Synced" status will immediately reflect as "False" upon any failure in asynchronous operations, ensuring compliance with the XRM contract and improving reliability in status reporting. Previously, the error handling only updated the LastAsyncOperation status without properly setting the Synced condition to False. For more information, please see the detailed PR description.

What's Changed

• Changed 404 routes by @​danielsinai in https://github.com/crossplane/upjet/pull/310
• Adds erhancagirici and mergenci as maintainers by @​jeanduplessis in https://github.com/crossplane/upjet/pull/352
• Check LateInitialize management policy in Plugin Framework external client by @​mergenci in https://github.com/crossplane/upjet/pull/350
• Add .license files for the JSON test artifacts by @​ulucinar in https://github.com/crossplane/upjet/pull/354
• Fix slice type sensitive fieldpath generation by @​sergenyalcin in https://github.com/crossplane/upjet/pull/355
• fix link in docs by @​tomasmota in https://github.com/crossplane/upjet/pull/356
• small docs corrections by @​tomasmota in https://github.com/crossplane/upjet/pull/357
• Swap SYNCED and READY columns in output by @​bobh66 in https://github.com/crossplane/upjet/pull/360
• Remove img.build make target by @​bobh66 in https://github.com/crossplane/upjet/pull/362
• Fix go code spacing in configuration-a-resource.md by @​jaylevin in https://github.com/crossplane/upjet/pull/363
• Removing the applying of StateFuncs to parameters by @​sergenyalcin in https://github.com/crossplane/upjet/pull/358
• Move license statements to separate files (for tmpl files) to prevent license statement duplication by @​sergenyalcin in https://github.com/crossplane/upjet/pull/373
• Add the Header Go template variable to setup.go.tmpl by @​sergenyalcin in https://github.com/crossplane/upjet/pull/376
• Add a new configuration option for required field generation by @​sergenyalcin in https://github.com/crossplane/upjet/pull/381
• Add external API calls metric by @​mergenci in https://github.com/crossplane/upjet/pull/385
• Introduce MR metrics by @​mergenci in https://github.com/crossplane/upjet/pull/390
• Cache the error from the last asynchronous reconciliation by @​ulucinar in https://github.com/crossplane/upjet/pull/391

New Contributors

• @​danielsinai made their first contribution in https://github.com/crossplane/upjet/pull/310
• @​tomasmota made their first contribution in https://github.com/crossplane/upjet/pull/356
• @​bobh66 made their first contribution in https://github.com/crossplane/upjet/pull/360
• @​jaylevin made their first contribution in https://github.com/crossplane/upjet/pull/363

Full Changelog: crossplane/upjet@v1.2.4...v1.3.0

v1.2.4

Compare Source

v1.2.3

Compare Source

v1.2.2

Compare Source

v1.2.1

Compare Source

v1.2.0

Compare Source

v1.1.6

Compare Source

v1.1.5

Compare Source

v1.1.4

Compare Source

v1.1.3

Compare Source

v1.1.2

Compare Source

v1.1.1

Compare Source

v1.1.0

Compare Source

The v1.1.0 introduces several new features and enhancements

Multi-version Custom Resource Definitions (CRDs) generation and CRD conversion webhooks

The generation pipeline and the resource configuration framework now allow the generation of CRDs with multiple versions and conversion webhooks by conversion.Hub and conversion.Convertible implementations for the resource.Terraformed resources. The generated webhooks will invoke a chain of Conversions while converting from/to Hub versions to/from the spoke versions. There are currently two conversion types, conversion.PavedConversion and conversion.ManagedConversion.

We are also providing some high-level Conversions to implement some common API conversion tasks. conversion.NewFieldRenameConversion returns a new PavedConversion that implements a field renaming conversion from a specified source version to a specified target version of an API. conversion.NewCustomConverter can be used to initialize a new ManagedConversion that invokes a specified conversion function on a source and destination resource.Managed pair.

Terraform Plugin Framework resources support

This release introduces two new managed.Connecters and two new managed.ExternalClients (controller.terraformPluginFrameworkExternalClient and the controller.terraformPluginFrameworkAsyncExternalClient) which bring support for reconciling Terraform Plugin Framework resources in the new architecture without forking any Terraform CLI or Terraform provider processes. Consumers can specify resources in provider.TerraformPluginFrameworkIncludeList to generate them with Terraform Plugin Framework external clients. The nofork architecture now has the native implementations for both the Terraform plugin SDK v2 resources and the Terraform plugin framework resources. In this release, the NoFork terminology was replaced by TerraformPluginSDK.

What's Changed

• Add server-side apply merge strategy markers by @​negz in https://github.com/crossplane/upjet/pull/301
• Put default and configured timeouts to InstanceState for using the timeouts while Observe calls by @​sergenyalcin in https://github.com/crossplane/upjet/pull/309
• Call the registered schema.CustomizeDiffFunc functions in the Terraform SDK-based external client by @​ulucinar in https://github.com/crossplane/upjet/pull/311
• Make main-tf contents exported by @​therealmitchconnors in https://github.com/crossplane/upjet/pull/223
• Ignore specific error that returned by expandWildcard function by @​sergenyalcin in https://github.com/crossplane/upjet/pull/312
• Cache the Terraform instance state returned from schema.Resource.Apply even if the returned diagnostics contain errors by @​ulucinar in https://github.com/crossplane/upjet/pull/313
• Add config.Resource. ServerSideApplyMergeStrategies to configure the SSA Merge Strategies by @​ulucinar in https://github.com/crossplane/upjet/pull/308
• Pass full state to GetExternalNameFn function to access field other than ID by @​sergenyalcin in https://github.com/crossplane/upjet/pull/316
• Set the RawPlan for a new terraform.InstanceState returned from an observation by @​ulucinar in https://github.com/crossplane/upjet/pull/317
• Set diff state's Attributes to nil if the resource does not exist by @​ulucinar in https://github.com/crossplane/upjet/pull/318
• Add reference fields to the InitProvider by @​sergenyalcin in https://github.com/crossplane/upjet/pull/315
• Set RawConfig on the diff state by @​ulucinar in https://github.com/crossplane/upjet/pull/319
• fix image links in configuring-a-resource by @​smcavallo in https://github.com/crossplane/upjet/pull/322
• Add a nil check for the calculated instanceDiff while Observe by @​sergenyalcin in https://github.com/crossplane/upjet/pull/324
• Bump hashicorp/terraform-plugin-sdk to v2.30.0 by @​ulucinar in https://github.com/crossplane/upjet/pull/320
• fix broken link in docs by @​mbbush in https://github.com/crossplane/upjet/pull/328
• Fix the return type so it uses Upjet by @​jake-ciolek in https://github.com/crossplane/upjet/pull/330
• Generate a standalone "zz_generated.terraformed.go" file for each resource by @​ulucinar in https://github.com/crossplane/upjet/pull/326
• Add a transformer to remove API group imports for cross-resource references by @​ulucinar in https://github.com/crossplane/upjet/pull/331
• fix(environment): add missing environment specific patches TO/FROM by @​haarchri in https://github.com/crossplane/upjet/pull/332
• Multiversion CRDs & Conversion Webhooks by @​ulucinar in https://github.com/crossplane/upjet/pull/321
• Add configuration API parameter for overriding the field names by @​sergenyalcin in https://github.com/crossplane/upjet/pull/335
• terraform plugin framework external client & connectors by @​erhancagirici in https://github.com/crossplane/upjet/pull/329
• fix diff state not being set to freshly observed state for non-existing resources by @​erhancagirici in https://github.com/crossplane/upjet/pull/334
• Set the ID string to empty string on Terraform state for calculating the diffs by @​ulucinar in https://github.com/crossplane/upjet/pull/337
• Replace NoFork Terminology with TerraformPluginSDK by @​ulucinar in https://github.com/crossplane/upjet/pull/338
• Set CRD storage version to the latest generated version by @​ulucinar in https://github.com/crossplane/upjet/pull/339

New Contributors

• @​negz made their first contribution in https://github.com/crossplane/upjet/pull/301
• @​therealmitchconnors made their first contribution in https://github.com/crossplane/upjet/pull/223
• @​smcavallo made their first contribution in https://github.com/crossplane/upjet/pull/322
• @​mbbush made their first contribution in https://github.com/crossplane/upjet/pull/328
• @​jake-ciolek made their first contribution in https://github.com/crossplane/upjet/pull/330

Full Changelog: crossplane/upjet@v1.0.0...v1.1.0